package com.gengzp.system.mapper;

import com.gengzp.common.model.log.entity.SysTraceLog;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.Date;
import java.util.List;

/**
 * @ClassName SysTraceLogMapper
 * @Description 系统链路日志管理模块 Mapper 层接口
 * @Author gengzp
 * @Date 2025/9/28 16:00
 */
@Mapper
public interface SysTraceLogMapper {

    /**
     * 插入一条系统链路日志
     *
     * @param sysTraceLog 系统链路日志
     */
    void insertSysTraceLog(SysTraceLog sysTraceLog);

    /**
     * 根据 traceId 查询系统链路日志集合
     *
     * @param traceId 链路追踪id
     * @return 系统链路日志集合
     */
    List<SysTraceLog> selectSysTraceLogsByTraceId(String traceId);

    /**
     * 根据截止时间清理历史堆积的链路追踪日志
     * <p> 该方法会物理删除创建时间早于 deadline 的所有链路追踪日志 </p>
     */
    void clearHistoricalAccumulationSysLog(@Param("deadline") Date deadline);

}
